home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / enigma / earcd / sviluppo / svilupp1 / clib37x.rdm < prev    next >
Text File  |  1997-01-18  |  7KB  |  168 lines
  1. Short:    Example.library in 100% C (SAS/Storm/Maxon)
  2. Author:   Andreas_Kleinert@t-online.de (SAS/Storm), hhummel@t-online.de (Maxon)
  3. Uploader: Andreas_Kleinert@t-online.de
  4. Type:     dev/c
  5.  
  6.   example.library, test program and source-code V37.4 (8.1.97)
  7.   ->> Yet at least works with: SAS/C 6.5x, MaxonC 3.x and StormC 2.x <<-
  8.  
  9.   SAS/C and StormC version (C) 1996-97 by Andreas R. Kleinert.
  10.   MaxonC changes done by Helmut Hummel (-> Readme.MAXON).
  11.   All rights reserved.
  12.  
  13.   ---
  14.   This small sample library source code demonstrates, how to completely
  15.   write an Amiga Exec shared library without any assembler stubs
  16.   or compiler/linker tricks in PURE C source code.
  17.  
  18.   You may e.g. use this example source code to write more portable
  19.   Amiga Exec shared libraries to allow easier porting of these
  20.   to other Amiga OS-derived operating systems, or the native
  21.   OS of an upcoming PowerPC Amiga.
  22.  
  23.   Translate your 68k-assembler library startup-codes smartly
  24.   to C by simply using this source-code as an advice how to do it.
  25.  
  26.   It is _not_ the *ultimate* answer, but a step, which has to be made.
  27.  
  28.   For testing: install the (re)compiled example.library to LIBS: and
  29.   start the test program - it should pop up an requester, then.
  30.   ---
  31.   Feel free to use this source for own projects.
  32.  
  33.   It is allowed to be spread and distributed anywhere, as far
  34.   as my consent is concerned.
  35.  
  36.   Amiga Technologies, or the current owner of the technologie,
  37.   is allowed to always put this source on their newest
  38.   Developer CD-ROM.
  39.  
  40.   Thanks and credits will always be appreciated - for example,
  41.   you MAY, but NEED NOT:
  42.   give me credits in your program's docs, send me keyfiles for
  43.   your programs using the library, and so on.
  44.   But that's simply voluntarily.
  45.  
  46.    _________________________________________________________
  47.   |      You may reach me the following way.                |
  48.   |    Send bug-reports, money or whatever to:              |
  49.   |---------------------------------------------------------|
  50.   |        * SuperView Development & Registration *         |
  51.   |          * DRAFU Development & Registration *           |
  52.   |       * Image Engineer Registration Site Europe *       |
  53.   |                                                         |
  54.   |                                                         |
  55.   |                  PerSuaSiVe SoftWorX                    |
  56.   |                                                         |
  57.   |                  Andreas R. Kleinert                    |
  58.   |                  Sandstrasse 1                          |
  59.   |                  D-57072 Siegen                         |
  60.   |                  Germany, Europe                        |
  61.   |                                                         |
  62.   | Any snail mail to the old address will still be routed. |
  63.   |                                                         |
  64.   |                  Phone:  +49-271-22869 also FAX + AM    |
  65.   |                          +49-271-22838                  |
  66.   |                                                         |
  67.   |                  Weekdays after 17.00h.                 |
  68.   |                                                         |
  69.   |         When calling via phone you may leave a message, |
  70.   |         if I'm not available - but don't expect me      |
  71.   |         calling back to USA, Australia, ... since       |
  72.   |         german phone rates are HIGHLY expensive.        |
  73.   |_________________________________________________________|
  74.  
  75.     http://home.t-online.de/home/Andreas_Kleinert/
  76.  
  77.   eMail:
  78.  
  79.         Please send binaries via ARK@COB.wwbnet.de, and keep
  80.         them smaller than 16 KB. Please think twice before
  81.         sending them - my postbox is not unlimited in size.
  82.  
  83.            - Fido    Andreas Kleinert 2:2457/350.18
  84.            - Usenet
  85.                      Andreas_Kleinert@superview.ftn.sub.org  (Fido-Gate)
  86.                      Andreas_Kleinert@t-online.de            (T-Online)
  87.                      ARK@COB.wwbnet.de                       (Z-Netz)
  88.                      ARK@amigaworld.com                      (AmigaWorld)
  89.  
  90.            - If nothing else works, try one of these public
  91.              Fido-Usenet gateways:
  92.  
  93.                In Germany:
  94.                  Andreas_Kleinert@p18.f350.n2457.z2.fido.sub.org
  95.  
  96.                From USA or elsewhere:
  97.                  Andreas_Kleinert@p18.f350.n2457.z2.fidonet.org
  98.  
  99.         Please note, that the "superview.ftn.sub.org"
  100.         domain will perhaps be renamed soon
  101.  
  102.  
  103.  History:
  104.  
  105.  V37.4 (8.1.97) :   - added FD file
  106.                     - added new pragma file (and dir) as
  107.                       include/pragma/example_lib.h
  108.                       which works with Aztec, Maxon, Storm,
  109.                       DICE and SAS C compilers.
  110.                       Thanks to fd2pragma and Dirk Stoecker.
  111.                     - some fixes to the readme files
  112.                     - updated eMail list
  113.  
  114.  V37.3 (3.1.97) :   - slightly changed SCOPTIONS
  115.                     - fixed some style things (APTR and library casts)
  116.                     - changed note about library opening at L_OpenLibs()
  117.                     - now compileable with StormC 2.0 as well
  118.                       (not tested with 1.1) - see readme file for StormC
  119.                     - added project file for StormC 2.0, smakefile still
  120.                       present - select, which one you'd like to use
  121.  
  122.  V37.2 (12.12.96) : - applied some more changes and fixes
  123.                       (-> suggested by Helmut Hummel)
  124.                     - added icons
  125.                       (-> from Helmut Hummel)
  126.  
  127.  V37.1 (4.12.96) : - bumped version to V37
  128.                    - added MaxonC 3.x version by applying changes
  129.                      to the SAS/C sources and adding Maxon
  130.                      specific make and configuration files
  131.                      (-> all done by Helmut Hummel, see Readme.MAXON)
  132.                    - added StormC support
  133.                    - yet missing: DICE, Aztec, GNU. Who does it ?
  134.  
  135.  V1.4 (30.11.96) : - added SAS/C specific Ctrl-C disabling code
  136.                    - made some workarounds compiler sensitive
  137.                    - redone all with SAS/C V6.57
  138.                    - 944 Bytes ;-)
  139.  
  140.  V1.3 (13.9.96) :  - when starting lib as executable, -1 must be returned
  141.                    - now caching SysBase
  142.                    - added some comments, where changes should not
  143.                      be applied
  144.                    - added note about sharing library bases
  145.                    - documented and modified sample function,
  146.                      so that correct a0/a1/d0/d1 and a6 usage becomes
  147.                      more obviously and verbose
  148.                    - still 940 bytes ;-)
  149.  
  150.  V1.2 (5.9.96)  :  - fixed some things resulting out of a
  151.                      discussion in Z-Netz
  152.  
  153.  V1.1 (1.9.96)  :  - small changes in style
  154.                      (only bumped versions of changed modules):
  155.                        o moved "examplebase.h" to include/example/
  156.                          (so also adjusted LibInit.c, StartUp.c
  157.                           and SCOPTIONS for reflecting that)
  158.                        o SampleFuncs.h did contain wrong prototype
  159.                          (did not matter, since only used for
  160.                           ULONG function table within StartUp.c)
  161.                        o explicitely __aligned ROMTag structure
  162.  
  163.  V1.0 (14.8.96) : - first release
  164.  
  165.  
  166.  ---
  167.  All mentioned trademarks are subjects to their owners.
  168.